.TH E1432_GET_FWREV 3 E1432
.SH NAME
e1432_get_fwrev \- Get revision of "sema.bin" file
.IX e1432_get_fwrev(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_get_fwrev(char *path, LONGSIZ32 *fwrev)
.cE
.SH DESCRIPTION

\fIe1432_get_fwrev\fR returns the firmware revision for the file
specified by \fIpath\fR.  This file should be a \fCsema.bin\fR file that
could be installed in an E1432/E1433/E1434 module.

\fIpath\fR is the path to the \fCsema.bin\fR file, including the
\fCsema.bin\fR filename.  The typical value to use for \fIpath\fR would be
\fC/opt/e1432/lib/sema.bin\fR.

\fIfwrev\fR should point to a 32-bit integer.  This integer will get
filled with the firmware revision for the \fCsema.bin\fR file.  The
revision is of the form "19970416".  It is a decimal integer
containing a four-digit year followed by a two-digit month followed by
a two digit day.

If this \fCsema.bin\fR file is installed in an E1432/E1433/E1434 module
using \fIe1432_install\fR, and then if \fIe1432_get_hwconfig\fR is
used to get information about the module, the \fIfw_rev\fR field in
the \fIe1432_hwconfig\fR structure will be equal to the \fIfwrev\fR
returned by this function.

The typical user will probably not need to use this function.  Its
purpose it to provide a way to compare a \fCsema.bin\fR file in the host
computer with the firmware that is executing in a module, to see which
is newer.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_get_hwconfig, e1432_install
.ad
